Atari Mega Archive 1

home *** CD-ROM | disk | FTP | other *** search

/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / apps / other / newgen.lzh / newgen.doc < prev next >

Wrap

Text File | 1992-03-10 | 116KB | 2,418 lines

NEWGEN A Computer Program to aid Genealogists. Version 4.10 CONTENTS -------- 1. Introduction 2. Colour 3. Getting started 4. Files supplied 5. Equipment required 6. Files and disks 7. Disks and drives 8. Setting up to use NEWGEN 9. Using NEWGEN 10. The menu 11. Questions and prompts 12. The form 13. Identification numbers 14. Terminology and limitations 15. Using the form 16. Marriages 17. The function keys 18. General notes on using the form 19. The 0 option 20. Lists 21. Other menu items 22. Crashes and bugs 23. Updates and enhancements 24. Price list of NEWGEN 25. Disclaimer and conditions of use Appendix A FNTCON.PRG Appendix B PRINTIT.PRG Appendix C Joining strips Appendix D Printer codes Appendix E NEWGEN.INF Appendix F Character sizes Appendix G Enhancements in versions 4 About the author About NEWGEN For the more adventurous 1. Introduction --------------- NEWGEN is a program written for the ATARI ST family of micro computers (520, 1040, Mega or STE) and designed to help genealogists maintain the records of their researches and to print out birth briefs and pedigree charts. It may also be of interest to geneticists and plant or animal breeders. NEWGEN, unlike most application programs written for the ST, does not use GEM: windows, icons and drop down menus do not appear on the screen and you never have to use your mouse except to start running NEWGEN from the desk top. There are two reasons for this; firstly extensive use of GEM would have made the program considerably longer and it is desirable that it be compact enough to run on the 520ST; secondly GEM is admitted to be slow even by those programmers who delight in its use. So, alternatively, you communicate with NEWGEN to tell it what you want it to do entirely through the keyboard. NEWGEN displays questions on the screen and you answer them by pressing appropriate keys. Full explanations are also displayed so that you know what sort of answer is expected. If you enter a nonsense, NEWGEN will respond by asking again or telling you what is wrong. NEWGEN takes great care to preserve the integrity of the data you have entered so that it is unlikely that you will do anything that corrupts it or necessitates a laborious re-entry of data from scratch. Nevertheless you should ensure that you use good quality disks (you can be badly let down by using cut price disks or by using single sided disks formatted as double sided - I know from experience). To be on the safe side, you should backup your data file (NEWGEN.DAT) from time to time by copying it onto another disk from the desk top. Some of the facilities in NEWGEN take a little time to carry out. So that you do not think that NEWGEN has gone to sleep, a constantly altering progress report is displayed on the screen when appropriate. NEWGEN, when installed in memory takes up about 240 Kbytes. There may not be room enough for your favourite accessory. 2. Colour --------- Version 4 of NEWGEN (unlike previous versions) will work equally well using a colour monitor or a high resolution monochrome monitor. In fact colour is not used by NEWGEN and everything on the screen will be written in black on a white background (future versions may allow you to choose the colour - if you can see a good reason for using colour in some way, let me know). If you have a colour monitor, be sure to set it to MEDIUM resolution from the 'Set Preferences' menu of the desk top before you double click on NEWGEN.PRG. If you forget, NEWGEN will do this for you and work quite happily. But when you return to the desk top, you will find that the latter does not work properly - although even then you can reset the resolution from the 'Set Preferences' menu. 3. Getting started ------------------ To get started, I suggest you follow the instruction for setting up described in paragraph 8 below, double click on NEWGEN.PRG, and away you go. Follow the instructions on the screen and if you get stuck (which I do not think you will) refer to the detailed instructions in this document. If you like, you could, at the start, copy NEWGEN.DAT as supplied onto your data disk (see below) and play with that before you start serious work. When you are ready for serious work, delete these demonstration versions of NEWGEN.DAT and NEWGEN.TRE from your data disk and start again. Note that you should always have a copy of NEWGEN.RSC and NEWGEN.INF on the same disk as NEWGEN.PRG. Moreover, NEWGEN.RSC must by the one supplied with the the version of NEWGEN.PRG you are using and NEWGEN.INF must similarly have been created using the version of GENINF.PRG supplied. The forms of the .RSC and .INF files vary from version to version. 4. The files supplied --------------------- The files supplied on the disk (formatted single sided, since not everybody has a double sided disk drive) you have received are as follows: 1. NEWGEN.PRG This is the main program. Details of how to use it are given below. 2. NEWGEN.RSC This file contains a description of the data entry form, of the menu and of the codes that are sent to the printer NEWGEN will not work unless this file is present on the same disk as NEWGEN.PRG Moreover it must be the same file as was supplied with the program. 3. GENINF.PRG This is an 'initialisation' program which you must run before attempting to use NEWGEN. You must use the version supplied with the NEWGEN.PRG. 4. FNTCON.PRG This is a program you can use to convert font files to a form acceptable to NEWGEN. 5. NEWGEN.DOC This is this the file you are reading. You can obtain a printed copy with the aid of PRINTIT.PRG (see appendix B). 6. NEWGEN.DAT This file contain a fictitious set of records with which you can demonstrate to yourself the facilities of NEWGEN before you start serious work on your own family data. 7. PRINTIT.PRG A program for printing ASCII files in condensed characters (132 to a line) or with page breaks and numbers. 8. SERIF.GNT A sample font file you can use in printing pedigree charts. It is supplied free of charge. 9. DESKTOP.INF This specifies the form of your desktop You may want (or need) to change this in the usual way. 10. NEWGEN.NOT A file containing a table of dates useful to the British genealogist 4. Equipment required --------------------- To run NEWGEN you will require the following: An ATARI ST computer - 520, 1040 or Mega or STE A monitor (or TV if you have a modulator); NEWGEN 4.10 will work equally well with a high resolution monochrome monitor or a colour monitor (or TV) in medium resolution mode. At least one single or double sided floppy disk drive (such as the one built into your keyboard) A dot matrix printer; this should be EPSON compatible (but see Appendix D) and connected through the centronics port. Several disks Fan folded paper for your printer A second disk drive is desirable but by no means necessary; In essence, the more disk capacity you have, the more people you can enter into your data base files up to a limit of 999. A hard disk is recommended but NEWGEN will work well without one. 6. Disks and drives ------------------- NEWGEN can be operated in one of three modes. Which mode is chosen depends on the number of drives available on your system and their type: Mode A. A single floppy drive (A) only is available. Mode B. At least two drives, none of which are hard drives, are available; they may be floppies or RAMDISKS. Mode C. One or more hard drives (or partitions) are available as well as any floppies etc. When you run GENINF.PRG, you must inform it which drives are available to it. NEWGEN will then select the appropriate mode as indicated above. You need not enter all your drives, but they should be in entered in alphabetical order. Floppies should be drives A and/or B If you have specified more than one drive, NEWGEN asks you to select one or other of them to be loaded with your data disk (see below). 7. Files and disks ------------------ To use NEWGEN you will require several disks (if these are floppy disk, these should ALL be formatted the same size, single or double sided, preferably double): 1. The program disk to contain: NEWGEN.PRG NEWGEN.RSC DESKTOP.INF (optional) GENINF.PRG FNTCON.PRG PRINTIT.PRG NEWGEN.INF The first six of these are supplied. NEWGEN.INF is created by GENINF.PRG 2. The data disk to contain: NEWGEN.DAT NEWGEN.TRE NEWGEN.NOT Font (.GNT) files NEWGEN.DAT is created by NEWGEN and contains all the information you enter; it is valuable. NEWGEN.TRE is constructed from the data in NEWGEN.DAT by NEWGEN and contains tables of family relationships etc. It can be reconstructed easily. NEWGEN.NOT is supplied and contains useful data which can be edited or replaced if you wish. .GNT files are created by FNTCON.PRG and contain alternative fonts. 3. The text disk to contain: NEWGEN.TXT This is created by NEWGEN and contains note-sheets 4. The auxilliary disk which will contain: NEWGEN.PED NEWGEN.DES NEWGEN.BRF NEWGEN.LST These files are created by NEWGEN and contain temporary data. If one of the drives you specify in NEWGEN.INF is a hard drive (so that you run in mode 3), NEWGEN will assume that your data, text and auxilliary disks are one and the same and will use the hard disk (or a partition thereon) for all three. Similarly, if you only have a singe floppy drive (mode 1) NEWGEN will assume that your data, text and auxilliary disks are the same floppy disk which you will insert in drive A. If you have two floppy drives or a single floppy and have installed a RAMDISK, NEWGEN will ask you to choose which is to be your data disk. It will assume that your text and auxilliary disks will be inserted in one of the other drives or that the RAMDISK will be used for such. If you are running in mode 2 with two floppies, NEWGEN keeps track of what disk, if any, is currently in drive B. All will be well provided you only remove or insert disks when so instructed. It is only realy feasible to use a RAMDISK if you have at least one Megabyte of RAM available (NEWGEN uses about 250 Kbytes). You must copy any NEWGEN.TXT to your RAMDISK before you invoke NEWGEN and after you have left it. If you turn your computer off, anything in your RAMDISK is lost for ever! If you have a 520 ST and one single sided drive, you may not have room to enter all the people you want. One thing that may help is to format your data/text/auxilliary disk using some utility program so that it has more sectors or tracks. If you do this, make certain that your disk has exactly 512 bytes in a sector and exactly 2 sectors in a cluster; if you ignore this, you run the risk of losing data. I will not be responsible if your data comes to grief because you overlooked these provisos. You can leave your program disk write protected, but your other disks should not be write protected. 8. Setting up to use NEWGEN --------------------------- 1. It is suggested that the first thing you do is to copy the following files into the main directory (NOT a folder) of a new (formatted) floppy disk (or your hard disk): NEWGEN.PRG (but this CAN be put in an AUTO folder) NEWGEN.RSC GENINF.PRG DESKTOP.INF This will be your PROGRAM DISK. Keep the original disk in a safe place as a backup. 2. Now ensure your new program disk is loaded and reset your computer; wait for the desk top to appear. If you are using a colour monitor, set the resolution to MEDIUM at the desk top ('Set Preferences' menu) 3. Now double click on GENINF.PRG from the desk top. You MUST do this even if you have used earlier versions of NEWGEN and already have a NEWGEN.INF file. GENINF.PRG varies from version to version. Several questions about your computer system will be displayed on the screen; answer them appropriately; you can press RETURN to specify the default reply for all but the first of them but to get the best results you will may have to consult your printer manual to discover the appropriate answer of some of them. The information required is: 1. The disk drive units that intend to use. Each drive unit and hard disk partition is identified by a letter in its icon in the desk top (A, B etc.) Enter a sequence of the corresponding letters and complete the command by pressing RETURN e.g. If have: one floppy drive units (A) (mode A) enter: A two floppy drive units (A & B)(mode B) enter: AB one floppy, (A) and a RAMDISK (D perhaps) (mode B) enter: AD a hard disk (partition C perhaps) (mode C) enter: C There is no need to enter ALL the drives available (and no harm in doing so), but those you do enter should be in alphabetical order. If you intend to use a RAM disk or a hard disk (or partition), be sure to include its letter in the list. Note well that the number of drive units you have corresponds to the number of slots into which you may insert a floppy disk plus the number of hard disks you have (if any) plus the number of RAM disks (or partitions) you are using (if any). This number does not necessarily correspond to the number of disk icons on your desk top (there are always at least two, even if you have no extra drives). 2. The length of the paper in your printer It is possible to buy fan folded printer paper in a bewildering variety of sizes. NEWGEN needs to know the length from top to bottom of a page of the paper you are using. The length may be specified in POINTS where one point is 1/72". Measure the length of your paper in inches and multiply by 72 (e.g.11" paper has a length in points of 792, the default value). Enter the length of your paper in points and press RETURN 3. The width of the paper in your printer Again, paper of various widths are available. The important number here is the width in inches available for printing on. You should enter an integral number and press RETURN e.g. if the distance between the perforations holding the sprocket holes is 8.5", enter 8 (the default value). Note that wide carriage printers can be used to print drop line charts. The paper width for these may be 13" or 15". (but its the actual paper width, not the carriage width that counts) 4. The graphics mode in which you will print drop line charts. Your printer must be capable of working in 8 bit graphics mode (if you can do a screen dump it certainly can; it may be capable, even if screen dumps are unsatisfactory). This being so, there is generally the option of using it with different resolutions; NEWGEN can be used with three of these: 1. Single density mode 2. Double density mode 3. CRT mode All three of these may not be available on your printer. Although CRT mode is the best (and the default), you may have to choose one of the other two. You will have to consult your printer manual to discover which mode is available and you may have to experiment. See also appendix D. 5. The horizontal dot pitch Whichever mode you choose, NEWGEN needs to know the corresponding horizontal dot pitch. That is to say the number of dots per inch in a row across the paper. The default value is 80. NEWGEN uses the horizontal dot pitch and the paper width to work out how many characters to write across the page. 6. The vertical dot pitch NEWGEN similarly needs the vertical dot pitch - the number of dots per inch down the page in 8 bit graphics mode. The default value is 72 NEWGEN uses the vertical dot pitch to work out the distance to move the paper up after printing each row of characters. 7. One of the code sequences used by Epson printers which sets the distance moved by the paper each time a new line is started is: ESC 3 <n>. This is usually described as moving the paper by n/X inches. You need to enter X. The default value is 216 (for some other printers it may be 180). The program creates a file called NEWGEN.INF which must be on your program disk. NEWGEN.PRG will not work unless NEWGEN.INF (as well as NEWGEN.RSC) exists on the same disk as it. If you change your system in any relevant way, or if drop line charts are not satisfactory, you can run GENINF.PRG again at any time to make changes. Note that each version of NEWGEN has its own version of GENINF; you MUST use the correct version. 4. If you have not specified a hard disk (or partition), finally format a disk to hold your data (this will be your DATA DISK.) and if you have specified two floppy drives, format two more disks (your text and auxilliary disks). You may, optionally, copy NEWGEN.NOT onto your data disk. You may also like to copy one or more .GNT files (see appendix A). 5. You are now ready to start using NEWGEN. 9. Using NEWGEN --------------- IMPORTANT: If you have used earlier versions of NEWGEN, make sure you delete NEWGEN.TRE from your data disk before using version 4.10 1. Ensure that your program disk is loaded in a convenient drive, and switch on your ST. If you have put NEWGEN.PRG into an AUTO folder, go to stage 5. 2. Ensure that the following files are on it in its main directory: NEWGEN.PRG NEWGEN.RSC NEWGEN.INF 3. If you are using a colour monitor, set the resolution to MEDIUM using the desk top 'Set Preferences' menu. 4. Double click on NEWGEN.PRG from the desk top. 5. After a few seconds, the program will have been loaded; If NEWGEN.RSC or NEWGEN.INF are missing from the program disk, an appropriate message will be displayed; continuation will not be possible and all you can do is to abandon NEWGEN. If this happens, ensure the missing file(s) is put on the program disk and try again. If you are using the wrong version of NEWGEN.RSC or NEWGEN.INF, a message will also be displayed. All being well a title page will be displayed; you can remove your program disk if it tells you. 6. You must now load your data disk (unless it is a RAMDISK or a hard disk (or partition) and tell NEWGEN which drive it is in. If you only have one drive unit, you MUST remove the program disk before you insert the data disk and in this case you have no choice of drive. 7. What happens next depends on whether data files already exist on your data disk: A. If this is the first time you have used NEWGEN with your data disk, it will ask you if you want to initialise your data file (NEWGEN.DAT). Presumably you will answer: Y Then NEWGEN will tell you that NEWGEN.TRE is absent or faulty (it will be absent!). It will then proceed to set up this file. B. If NEWGEN.DAT and NEWGEN.TRE already exist on your data disk in its main directory, the information in NEWGEN.TRE will be loaded into the computers memory. This will take several seconds depending on how many people you have entered. C. In certain rare circumstances (such as a power failure occurring last time you used NEWGEN or when you start with the NEWGEN.DAT file supplied), NEWGEN may tell you that NEWGEN.TRE is absent or faulty. Press any key to continue. There will then ensue considerable disk activity while the data normally loaded from NEWGEN.TRE is calculated afresh and then saved. This will take several seconds depending on how many people you have entered; a running report on the progress in this is displayed so you do not think NEWGEN has gone to sleep. N.B. NEWGEN.TRE contains tables of people's spouses and children; it also contains a table giving the alphabetical order of the surnames on record. People with same surname are ordered according to their year of birth. If you ever come to doubt that the ordering is correct, try deleting NEWGEN.TRE at the desktop from your data disk. 8. All being well, information concerning the number of people currently entered and the maximum number you can cram onto your data disk will be displayed. When you have digested this, press any key to continue 9. At last the first page of the menu will be displayed. 10. To quit NEWGEN, press S from the menu. If you have entered any new records or edited old ones, there will be disk activity as NEWGEN.TRE is saved to your data disk. Finally you will return to the desk top. If you are using a colour monitor and forgot to set the resolution as MEDIUM, your desk top may not function properly when you leave NEWGEN (though NEWGEN itself will have worked properly) 10. The menu ------------ The menu consists of two pages. At the start, you will see the first page. You can move to the next page by pressing N (for Next); you can return to the previous page by pressing L (Last). To leave NEWGEN press S; resist the temptation to quit NEWGEN by turning the computer off or by similar unorthodox methods. No permanent harm would result, but it would result in one of those rare circumstances mentioned above. Otherwise you can select one or other of the facilities listed in either page of the menu by pressing its index letter key. Each facility is described in full below. Here are the menu items: Page 1 A. Enter/edit record of a person B. Print/display/save list of persons C. Print records/note sheets D. Display/print family of a person E. Print/display/save birth brief F. Print/display/save a descendant list G. Construct/save a drop line tree H. Print current drop line tree Page 2 A. Display useful information B. Create/edit note sheets C. Print note sheets D. Check all data on record E. Define macros F. Define drop line tree format G. Enter current date H. Change data disk S to quit; N for next page of menu; L for previous page of menu. 11. Questions and prompts ------------------------- Apart from the facility to enter data in the form (see below), each each facility you select will ask you one or more questions by displaying PROMPTS on the screen. As each prompt is displayed, the bell of the computer will ping. If this annoys you, turn down the sound volume control. You will generally see a CURSOR, a black square flashing on and off next to the current prompt. There are several sorts of prompt which require you to reply in different ways: 1. Some prompts ask a question which requires an answer, Yes or No. To reply YES, press the Y or y key; to reply NO, press the N or n key. You should NOT press RETURN afterwards (in actual fact you reply NO by pressing any key except Y or y). 2. Other prompts require you to PRESS a key. Respond by pressing the appropriate key (with no RETURN). For a single figure number press the appropriate key in the top row of the keyboard or in the auxiliary keyboard on the right. 3. Other prompts require you to ENTER some item of information (such as the ID number of a person). Respond by pressing one or more keys in sequence as appropriate and then signal that there are no more by pressing RETURN. You can erase the last character (before you press RETURN) if you make a mistake, by pressing BACKSPACE. 4. Sometimes reference is made to the ARROW KEYS. There are four of these pointing UP, LEFT, DOWN and RIGHT. Press one as appropriate. 5. Some prompts are intended to allow you to abandon something you have already started or 'escape'. Some of these may invite you to press ESC to escape or RETURN to continue. Respond by pressing the appropriate key. 6. In some cases you have to modify the effect of a key by holding down the Control, Shift or Alternate key while you press the key to be modified (probably you will be familiar with modifying a key on a typewriter by pressing the shift key in a similar manner). If you make an inappropriate reply to a prompt, NEWGEN will ignore it and display the prompt again to give you another chance. Even if your pet cat walks up and down your keyboard (avoid getting fur into the works!) no harm should result. When you press a key, give it a quick, light jab. Do NOT place your finger on the key and hold it down; if you do, it will, after a short delay, be as if you pressed the same key several times - with unforeseen results! (Your ATARI manual tells you how to adjust the delay to suit your personal response time; you can save the setting with your desktop) N.B. Your mouse can rest while NEWGEN is running - it is never used 12. The form ------------ If you invoke option A on page 1 of the menu, a blank form will be displayed on the screen. You use this to enter or edit particulars of people. This is what the blank form looks like: ------------------------------------------------------------------------------- Form to enter or edit a record for a person Surname: ____________ First names: ____________ ____________ ____________ Father: ___ Mother: ___ Gender [M,F]: _ ID number ( ): ___ Born on: ___________ at: _____________________________________________ Ref: ______________________ Baptised on: ___________ at: _____________________________________________ Ref: ______________________ Died on: ___________ at: _____________________________________________ Ref: ______________________ Funeral on: ___________ at: _____________________________________________ Ref: ______________________ Marriages: 1. On: ___________ To: ___ at: __________________________________________ Ref: ______________________ Children: __ 2. On: ___________ To: ___ at: __________________________________________ Ref: ______________________ Children: __ 3. On: ___________ To: ___ at: __________________________________________ Ref: ______________________ Children: __ Occupation: ____________ Abode: ____________ Note sheet: _ F1 saves form; F2 quits form; F3 clears form; F4 refreshes screen F5 clears field; F6 clears data; F7 makes spare; F8 creates/edits note F9 saves form & copies marriage data; F10 defines macros _______________________________________________________________________________ Fig. 1 The blank form _______________________________________________________________________________ You will see that there are 38 horizontal lines, each composed of one or more 'underlines' and preceeded by a short description. These are called FIELDS. Information is entered into these fields in a manner to be described below. The fields labelled 'children' and 'note sheet' are reserved and cannot be changed by you but here is a list of the other 34 fields in the order they are on the form and an indication of the nature of the information you will normally put in them: 1. Surname 2. First name #1 3. First name #2 4. First name #3 5. Father's ID 6. Mother's ID 7. Gender, M or F 8. Person's ID 9. Date of Birth 10. Place of birth 11. Reference 12. Date of Baptism 13. Place of baptism 14. Reference 15. Date of Death 16. Place of death 17. Reference 18. Date of Funeral 19. Place of funeral 20. Reference 21. Date of marriage #1 22. ID of spouse #1 23. Place of marriage 24. Reference 25. Date of marriage #2 26. ID of spouse #2 27. Place of marriage 28. Reference 29. Date of marriage #3 30. ID of spouse #3 31. Place of marriage 32. Reference 33. Occupation 34. Abode It is not suggested that everyone has three spouses or that you will know precise (or indeed any) details to put in all of these fields. Inevitably several will be left blank. If you are prepared to be unorthodox, you can place snippets of information in unused place or reference fields. 13. Identification numbers -------------------------- Each person you enter by means of the form is allocated an identification number or ID number for short. This enables you to refer to a particular person without ambiguity. ID numbers start at 1. The largest depends on how much room there is on your data disk. The following table lists the largest numbers for different types of disk. If you have other files besides NEWGEN.DAT and NEWGEN.TRE on your data disk, these maxima will be reduced accordingly: Highest ID number Single sided floppy disk 454 Double sided floppy disk 916 Hard disk 999 If you need to enter more than 999 persons you will need to obtain NEWGEN5K - see section 23. It may be possible to increase the number of people you can cram onto a floppy disk by formatting it in a non-standard way using one of the special programs available commercially or in the public domain. I cannot comment on whether this would work satisfactorily (see section 7). The number shown in the form in parentheses next to 'ID number' is the next free number. Each time you add another person to your records, this number will be increased by one, up to the limit and your data base will grow by one RECORD (a record contains 784 bytes). Thus each record is numbered by an ID number and contains the details you have entered for the corresponding person. There is no mechanism in NEWGEN for deleting a record, but you can assign an ID number (and its record) to another person by editing it; you will also have to ensure that any references to it in other people's records are altered too. You can find out who these may be by listing the person's family using option D.1. You can if you wish, give as surname: (Spare), or some such word so that it is ready for use when required; there is a special facility for doing this. It is useful to print out from time to time or display a list of all the people you have recorded. You can arrange to have this list printed in the order of the ID numbers or, alternatively, in alphabetical order of surnames with people with the same surname (more often the case than not in genealogy) ordered according to their year of birth or baptism (whichever is recorded). You can also list all the people with a given surname (togther with their ID numbers) or the people who have no relatives (isolates). 14. Terminology and limitations ------------------------------- A SPOUSE, as far as NEWGEN is concerned, is a person to whom another person is MARRIED. Marriage does not necessarily imply that the relationship was SOLEMNISED and NEWGEN allows you to record the distinction and indicate it in pedigree charts and lists You can record up to three marriages for a person and each of the three spouses can have two extra marriages to other people; this can lead to quite complicated interrelations if you come across them. NEWGEN has no special provision for recording divorces or bigamous or unproductive marriages or re-marriages. A person may have (as far as NEWGEN is concerned) up to 16 children in toto. He or she may have them by one, two or three spouses, but no more than 16 in all may be recorded for a given person (My copy of the Guinness Book of Records records that Elizabeth Greenhill gave birth to 39 children between 1652 and 1690 - she would stimy NEWGEN; NEWGEN is perhaps not suitable for genealogy in countries where polygamy is rampant). The children of a person and a given spouse constitute a FAMILY. A person may thus have up to three families. But note that a third family, although you can record it, CANNOT be displayed in drop line charts, though it can in descendant lists (see below). NEWGEN can cope with marriages between cousins and any resulting progeny. It can even cope with more incestuous relationships. NEWGEN knows little biology. In fact it is very naive on such matters. It will happily accept marriages between people of the same gender and even offspring of such unions! you can even tell it that a person is his own grandpa. You may not care to record such bizarre events, and if so, you should take care to avoid entering them; there is, however, a limited facility to detect them. All it really knows is that members of a family must have the same mother and father and that a family must have two parents. 15. Using the form ------------------ The form is used to enter or edit various details of people. Different types of information are entered into the different fields. A flashing cursor indicates the current field. You can move the cursor from one field to another by pressing one of the arrow keys, TAB or RETURN. Let us agree to call such keys TERMINATOR KEYS or TKs for short. Holding a TK down results in a rapid movement of the cursor from one field to the next (the order in which the cursor visits the various fields is not altogether straightforward - it is best to experiment till you get the hang of it). The first thing to do is to enter the ID number. Use the number in parentheses to create a new record for a new person; use a number less than this to edit the record of someone you have already entered. Ensure that the cursor is on the ID number field and type in the number. Finish by pressing a TK. If you are editing, the current details for the person you specified will be written into the form. If you are creating a new record there is not yet any data to display! In either event the cursor will leap to the Surname field and you can proceed from there. For most of the fields you can enter whatever printable characters (including 'space') you choose by typing them in and finishing with a TK. Certain fields are, however, more choosy. The fields (5,6,8,22,26 & 30) used to specify ID numbers will only accept the digits 1,2,3,...9,0; any others will be ignored. Similarly 'Gender' will only accept M, m, F or f. Here are some details about the individual fields: 1: Surname You can enter up to 12 characters. If this is not enough, you must use some sort of abbreviation. The surname is one of the fields that MUST be filled before you can store the data from your form. If you do not know the surname of a person, I suggest you enter: (Unknown). If a record number is not in use, I suggest you enter as surname: (spare) 2,3,4: First names Again only 12 characters are available. If somebody has fewer than three first names, you could use the extra fields to record such things as 'adopted' or 'no issue' or a nickname. 5,6: Father and mother Enter the ID numbers of the father and mother. If you have not yet created a record for either of them, you have two options: 1. Leave field blank till you have created one and then edit the child's record inserting the number whose record you have just created 2. Enter 0; this is much easier and a feature of version 4. When you come to save the record, the 0 will be replaced by the next free number available and a record for it automatically created. This facility is further explained below. 7: Gender Enter M (or m) or F (or f); this is another field that must be completed. 8: ID of person You will find that you cannot move the cursor to other fields till you have entered the ID of the current person here. 9,12,15,18,21,25,29: Dates You can use whatever convention you like for specifying dates; e.g. 2/3/1932 or 2-Mar-1932, or in the American convention 3/2/1932 or MAR-2-1932, or if you only know an approximate date c.1932 or 1932 or ~1932 or even <1933 or >1931 (but dates preceded by < or > never appear in charts or lists, being too vague) You can even enter: 'in infancy' or 'as child' in the death date field if appropriate; you may even care to put 'adulterous' in a marriage date field. If you have no information at all, leave the field blank. You should note that if the last four characters are digits, they are taken to represent a year (just in case you contemplating some way out genealogy involving dates B.C., do not use negative years; it will not work! and I have no advice to give you). The year of the birth date (field 9) is used to specify the order in which children are displayed in pedigree charts and in listings of people. If it is undefined, the date of baptism (field 12) is used instead. If this too is undefined, such people are listed last in pedigrees and first in listings. In listings and pedigree charts, dates are preceded by a letter which indicates their significance as follows: b. Birth x. Baptism (Christening) d. Death f. Funeral (burial) m. Marriage There is one final point about dates. If the first character in the date of death field is 'A', it is taken to mean that the person is still alive and their death (or funeral) will not be alluded to in any output, to the possible embarrassment of you or them. 22,26,30: Spouses Here you must enter the ID number of the person's spouses. If the spouse has not yet been entered, you can enter 0 (see Mother and Father above) The 0 will be replaced by the next number available when the record is saved. You should not enter the same spouse more than once. NEWGEN does not cope with remarriages or divorces. 10,13,16,19,23,27,31: Places You can write what you like in these fields but they are intended for the recording of places of the corresponding events. Information in these fields is not otherwise used in any way by NEWGEN. 11,14,17,20,24,28,32: References These fields are similarly not used by NEWGEN but you may care to use them to record the source of your information concerning the corresponding event. N.B. If you place X or x in the first positions of fields 24,28 or 32 the corresponding marriage is displayed in pedigree charts (see below) in a special way to indicate that it was not solemnised (this implies that any offspring are illegitimate). 33: Occupation You can use this field to record the occupation (trade, vocation etc.) of the person. 12 characters are available. 34: Abode You can similarly use this record to record the town, village, county etc. where the person lived. 12 characters are available. Four of the fields are not included above and cannot be altered by you; they are: Children In each you will find the number of children so far entered for the corresponding union. Note sheet This contains 'Y' or 'N' according to whether a note sheet for the person on the form has been set up (see option B.2) 16. Marriages ------------- Marriages deserve special comment. The ID numbers you enter into fields 22, 26 and 30 of person A, define the people who are A's spouses. The data in the corresponding date, place and reference fields describe the marriage from A's point of view. If you entered B in the ID field of a marriage, you would normally want one of the ID fields in B's record to contain A,and the other fields the same corresponding information. However, this requires special action on your part. In fact the description of the same marriage from A's point of view may differ from the description from B's point of view. There are two ways of ensuring the descriptions are the same: 1. By entering the same data in both A and B's form 2. By using the F9 key as described below It is also important to note that any information appearing in a family group, birth brief or pedigree that relates to a marriage is taken from the spouse's description - the spouse being the person married to a descendant. Because of this, trees describing matrilineal and patrilineal descent may show different marriage dates or opinions as to whether the marriage was solemnised. See the note in the previous section about 'children' fields. 17. The function keys --------------------- The function keys labelled F1 to F9 are used to do things with the form, perhaps when it is completed. When you press one, special things happen: F1 Save form ------------ When you have filled in the form to your satisfaction, you can save the the information on the screen into the data file, NEWGEN.DAT, by pressing F1. If you have left fields 1, 7 or 8 blank, NEWGEN will refuse to accept the data. Note that this (and after pressing F9) is the ONLY occasion that NEWGEN.DAT is written to. F2 Quit form ------------ When all is done and you want to return to the menu, press F2 Note that if you press F2 before pressing F1 (or F9) while information is shown on the screen, the latter is NOT saved. Save it with F1 first if you need to. F3 Clears form -------------- The entire contents of the entire form can be deleted by pressing F3; it then appears as you first found it. Nothing happens to NEWGEN.DAT This is useful if you have entered the wrong ID F4 Refreshes screen ------------------- If, in some unforseen manner, the screen display becomes corrupted, it can be put right by pressing F4. F5 Clears field --------------- The entire contents of the current field can be deleted by pressing the F5 key. This is useful if you have entered a wrong piece of information. F6 Clears data -------------- This has almost the same effect as F3; the difference is that the ID number is not deleted. This is useful if you have loused up several fields in some way and wish to begin again with the same ID. F7 Makes spare -------------- This deletes all fields except the ID; it then writes: (Spare) in the surname field and puts M in the gender field. This is useful if you want to expunge a person; if you now press F1, you have a spare record in NEWGEN.DAT. (Spare) will have no parents or spouse, but if the ID was previously that of some person, and that person was somebody's parent or spouse, such parent or spouse will now be (Spare). To avoid this difficulty, you would have to edit the record of the relevant children and spouses separately. Use this facility with care! Option D.1 will help you to sort it out F8 creates/edits note sheet --------------------------- Pressing F8 enables you to record further information for the person (if any) whose ID is on the screen. See option B.2 below for further details. F9 saves the form and also copies marriages ------------------------------------------- F9 does everything that F1 does and more. It copies marriage data: For every marriage with a spouse defined in fields 22, 26 or 30 the data relevant to that marriage is copied into the appropriate fields of the spouse's record. Anything that was there before is overwritten. If the spouses record contained no marriage to the person whose data is copied, a new marriage is created for them. If you have entered a date, place or reference for a marriage, but no spouse's ID, no copying takes place (NEWGEN would not know where to copy it to) In this way you can avoid having to enter dates, places and references of marriages twice, once for each partner. I can (just) conceive of reasons as to why you might wish the details recorded for the two partners to be different, so you do not have to use this facility. This copying facility works even though you are using the 0 option to define the spouse's ID number. Use this facility with care. Note that there is no way of simultaneously deleting a marriage from the records of both partners. F10 Define macros ----------------- Use this to define macros as described under menu item E.2 Shift F keys ------------ If hold down one of the SHIFT keys and press a function key (F1 to F10), the string defined for the corresponding macro is written into the current field starting at the cursor position and finishing at the end of the macro or the end of the field, which ever comes first. Note that if the macro is undefined, nothing happens. Note also that only legal characters are copied into the field. Brief details of these functions are listed below the form to jog your memory. 18. General notes on using the form ----------------------------------- 1. Avoid leading or trailing spaces; they will tend to upset the symmetry of pedigree charts and other output. 2. The following fields are (or can be, see below) incorporated in pedigree charts: 1 Surname 2,3,4 First names 9/12 Date of birth/baptism 15/18 Date of death/burial 21,25,29 Marriage dates 33 Occupation 34 Abode The first character in fields 24,28,32 (Marriage reference) also indicates (if it is X) whether the marriage has been solemnised as mentioned above. If any of these fields (except the surname) are left blank, the corresponding item is not listed in pedigree charts. 3. The following fields establish family relationships: 5,6 Father's and mother's ID 22,26,30 Spouse's ID It is important to note that NEWGEN only knows that several people form a family if you indicate that they all have the same two parents. Even if you do not know who one (or even both) parents were, you must nevertheless enter both, first creating minimal records for the unknown parent(s) if necessary - you could, for instance, give these 'dummy' people the surname: (Unknown). You should also ensure that a marriage is entered for both partners; if you only enter the marriage for one partner, you may find that whole areas of your pedigree chart are missing. 4. Marriages of a person are listed in family groups and pedigrees in the order in which you have entered them in the record of the spouse, so you may wish to enter these in temporal order. 5. You will find that you cannot enter the same person as a spouse of somebody more than once. Thus re-marriages are not catered for by NEWGEN. This is because NEWGEN has no way of assigning children of such a repeated union properly to the right marriage (to overcome this would involve radical rethink of the whole program). 6. You must fill in the following fields: 1 Surname 7 Gender 8 ID number of person If you fail to fill in one or more of these fields, NEWGEN will not allow you to save the record. 7. The last character of the current field can be deleted by pressing the BACKSPACE key. 8. It maybe that you forget the ID number of someone whose record you wish to edit. If you press the HELP key, you will be invited to enter a surname or to press RETURN. If you enter a surname all people with that surname together with their ID number will be listed on the screen. If you press RETURN you return to the form. Names will be listed properly irrespective of whether what you enter or what you originally entered was in capitals or small letters. e.g. SMITH matches smith matches Smith or even SmItH and vice versa. 9. The function keys F1-F9 (at the top of the keyboard) have special effects listed above. 10. You can alter the data on a screen as much as you want but NEWGEN.DAT will remain unchanged till you press the F1 or F9 key (see below) 11. The usual way of creating or editing a record is first to enter an ID number in field 8. A quick alternative is to press the up or down arrow key modifying the effect by holding down the Shift key at the same time. 'Up' results in the record after the one last displayed with the next number in sequence being displayed. 'Down' results in the previous record. If you had not yet entered an ID number, NEWGEN assumes number. 12. It maybe that you have entered some item into one of the fields and find that you can no longer move the cursor. This is because the item you have entered is illegal. The cure is to delete the field (F5 does this) and start again or leave it blank. The following illegalities are detected in this way: 1. In fields 5 or 6: when the parent whose number you have just entered already has 16 children if you enter a number equal to or greater than the next available number shown in parentheses if you enter the same number for both parents 2. In field 8 if you enter a number less than 1 or greater than the next free number shown in parentheses 3. In fields 22, 26 or 30 if the spouse whose number you have just entered already has 3 other spouses of their own. if you enter a number greater than or equal to the next available number if you enter the same number in two or more of these fields (no remarriages) 19. The 0 option ---------------- As we have indicated above, you can enter 0 in fields 5, 6, 22, 26, or 30, instead of entering the ID number of a person whose record already exists. When you come to save the record by pressing F1 or F9, the 0's are replaced by the next number available AND a new record is created for them. The surname is written as (Blank) and the gender is set: with 0 in field 5 (father) Gender: M 0 in field 6 (mother) F 0 in field 22, 26 or 30 (spouse) M if current person is F F if current person is M Note that you can thus create up to 6 new records in one fell swoop. The only proviso being that there is room on the data disk for them all. If there is insufficient room, you will be unable to enter the 0. 20. Lists ----------- Several of the menu items result in lists of people. These may be displayed on the screen (D), printed on your line printer (P) or saved to a file on your auxilliary disk (S). If you opt to save, it may be that there is insufficient room on your auxilliary disk, in which case a message to that effect is displayed and the process is aborted. One possibility of aleviating this is to delete one or more of the files NEWGEN.LST, NEWGEN.BRF, NEWGEN.DES or NEWGEN.PED or possibly NEWGEN.NOT or one or more of your .GNT files if these are on your auxilliary disk. This problem is only likely to be acute if you only have one single sided floppy drive. Old versions of these files are always deleted before new ones are created. This affords a method of making space on your auxilliary disk by deleting them. Thus NEWGEN.LST, .BRF, .DES or .PED can be deleted from within NEWGEN by invoking menu items A.1, E.1, F.1 or G.1 respectively and pressing ESC after NEWGEN has told you it has deleted the file. NEWGEN.LST, NEWGEN.BRF and NEWGEN.DES are pure ASCII files which means they can be edited (perhaps using 1st Word in ASCII mode) and printed after you have left NEWGEN. Do not try to edit NEWGEN.PED As we have noted, lists (of people on record, birth briefs, descendants, useful data) may also be displayed on the screen. Generally the complete list will more than fill the screen. To obviate this, NEWGEN pauses when it approaches the end of the screen and writes: - more - You can continue by pressing any key except 'Q'. If you press 'Q', NEWGEN abandons the list without further ado. [ESC is not used here because the desk top uses 'Q']. 21. The other menu items ------------------------ The other facilities that you can choose from the menu are more straightforward and you should have no difficulty in using them even without reading the descriptions given below. Below they are listed in order. Note that A.1 refers to menu item A on page 1 of the menu, etc. A.1 Enter/edit details of a person ------------------------------------ We have dealt with this option at some length above B.1 Print/display list of persons on record --------------------------------------------- It is useful to print out, from time to time, a list of all the people you have entered. You can then refer to the list when editing and updating the records. This facility enables you to either display such a list on the screen or print it, or save it in NEWGEN.LST The list may contain all people on record, just those bearing a given surname or isolated people (Spares etc) who have no relations (parents, children or spouses). You can specify which type of listing you require. The list can be presented in the order of the ID numbers, or in the alphabetical order of surnames, people with the same surname being listed in the order of their year of birth or baptism; people for whom neither of these have been entered are listed first. You can select either sort of ordering. Which ever sort of list you choose, the name of each person is preceded by their ID number and, if they have a note sheet, the letter 'N'. The current date is written at the top of the list. C.1 Print record of a person ------------------------------ This facility enables you to print out a record of all the information you have entered on the form for a person. Paper is more durable than magnetic disks and you may like to file away printed copies of records you have entered. You can either specify the ID number of the person whose record you you want to print, or you can opt to print out the records of everybody on record, though this could take some time. You can select the following: a. To start each record on a new page or to run them continuously separated by a line b. To include any note sheets you have defined; these are printed below the record. D.1 Display/print family of a person ------------------------------------- With this option you can display on the screen a family group, the family of any person on record. You do this by entering their ID number. The information displayed includes details (names, dates and ID numbers) of the person, their parents, their spouses and their children. With this facility you can rapidly trace the ancestors or a line of descendants of anybody on record. When the family has been displayed, you have the option of printing it. E.1 Print/display/save birth brief ------------------------------------ A birth brief is a list of the ancestors of a person (the root person) which displays the root person, his 2 parents, their parents (the 4 grandparents), their parents in turn (the 8 great grand parents) and so on. This facility enables you to construct a birth brief of any person on record and to specify how many generations you require up to nine (including the root person). There are 256 people in the 9th generation and if you have managed to find out who more than a few of them are, you are to be congratulated. The full name and dates of each person listed are given. If a particular branch comes to an end in the records (i.e. you have not specified a parent of one of the ancestors), nothing more is printed in that branch. You can opt to include ID numbers for each person. You are given the choice of displaying the brief on the screen, printing it out or saving it in a file called NEWGEN.BRF. The current date (if you have set it, see option F.2) is written at the bottom of the brief. F.1 Print/display descendants of a person ------------------------------------------- This facility enables you to prepare a pedigree listing. That is a list which starts with a specified person and his spouses (if any), and includes all their descendants and their spouses. The people are listed down the page; the spouses of a descendant are listed below the descendant; their children are listed below them indented towards the right of the page. Vertical and horizontal lines connect parents to their children (in a manner easier to observe than to describe) and spouses of a person are listed in the order in which you entered them and are distinguished from descendants by being preceeded by '=' or '~' and by having their marriage date (if any) listed; if you print the list, spouses are in italics. Children are listed in the order of their year of birth or baptism; if neither of these was entered, such children are listed first. The families of children and their families etc. are listed immediately below the child, so separating him from his siblings (if any). Hence the need for indentation. You are prompted to enter the ID number of the person whose descendants you want in your list and the number of generations you wish to include. A maximum of 50 generations may be specified - this is sufficient to take you back to about the time of the Norman Conquest! - or you can specify ALL generations; in this case NEWGEN lists on and on till it meets descendants with no children. You can opt to include ID numbers and you can select the depth of indentation between generations. You can opt to display, print or save the list to NEWGEN.DES. There is one limitation that you should bear in mind: Unless you have a wide carriage printer, the maximum number of characters you can print on a line, even using narrow condensed characters is 132; the number of characters that can be displayed on the screen is even less, 80. For this reason only the first 132 characters of each line can ever be made visible - in fact NEWGEN never records beyond 132 characters in such lists To alleviate this problem you can specify the number of spaces each generation is indented relative to the previous one. The standard indentation is 5 spaces but you can choose to have as few as 2. With 5, the practical limit to the number of generations you can display is 25 before the surname starts to run off the end of the line; with an indentation of 2 spaces, you could get in 50 generations before this could happen. Each line of the listing contains the following items of information taken from the form record of the relevant person: Surname 3 first names Marriage date (spouses only) Birth date Death date If any of these items were left blank in the form, they are ignored in the listing. If all 7 items were included, the maximum length of the line (excluding indentation spaces) would be 88 characters A special problem arises when a descendant marries another descendant i.e. when they marry a cousin or some closer relative. If this happens the marriage is listed twice but a message indicating that it is a marriage between relatives is written below the second occurrence If they have children, their family and their grandchildren etc. are NOT listed twice. G.1 Construct/save a drop line (pedigree) chart ------------------------------------------------- This is perhaps the most useful facility; it enables you to save and later print a 'family tree' containing all descendants and their spouses starting with some defined person. Such trees are printed sideways; that is to say the characters are rotated through a right angle so that consecutive characters on a line are written down the page and the different lines occupy different columns across the page. In this way, the length of a line is virtually unlimited. Your drop line chart is printed in this way as one or more STRIPS; successive strips contain the information on later and later generations. All the strips are exactly the same length and can be joined together (if there are more than one) to form a composite chart (see appendix C). You are prompted to enter the ID number of person whose descendants you want in your tree and the number of generations you require. All generations or a maximum of 50 may be specified. If your tree extends for more than 50 generations (congratulations!) it will be curtailed at 50. As soon as you have entered this information an abbreviated form of the chart is displayed on the screen. Only the ID numbers of the people concerned are shown but horizontal lines (BARS) connect members of the same family; short down pointing TAGs from the bars point to the children and short up pointing tags point to the marriage of which the family is the fruit. Descendants are joined to their spouses by an '=' or a '~'sign (see below). All members of a given generation are displayed on the same line. There is one serious limitation: We have seen that a person can have as many as three spouses and that each spouse can bear him children. This means that you can enter data indicating that a person has three separate families. NEWGEN is unable to include more than TWO such families in a drop line chart. If the person has only two families whether they be with spouses 1 & 2, 1 & 3 or 2 & 3, both will be included in the chart, but if he has a family with all three spouses, the third family will NOT be displayed. You could, of course, print out this third family in a separate tree starting with the third spouse (but if she had married somebody else outside the family of interest, you would get their descendants as well!). [The reason for this anomaly is geometrical - there is just no space available to contain the middle family; there are various possible solutions to this problem: the spouses could be spaced further apart; there could be bar lines at two levels; or you can imagine more complicated devices. All of these would mar the symmetric appearance of the tree or make it appear too fussy and the program would be severely complicated. If I ever think of a satisfactory solution to this problem, NEWGEN will be updated. If you can think of one, let me know] Note that a spouse may appear several times if he or she marries different descendants. Similarly, a descendant may appear several times if he or she marries one or more of relatives. If there is a large number of generations (more than 12) or a large number of people in any one generation, only a part of this abbreviated chart will be visible on the screen. You can bring the hidden parts into view by pressing one or other of the arrow keys; directions for this are displayed. This abbreviated chart gives you a preview of the general form of the full chart you can produce. When you have tired of inspecting the abbreviated chart press ESC to abort or RETURN to continue and to go on to write the full tree into NEWGEN.PED. In the full chart, each ID number is replaced by a rectangular block of characters which contain various items of information. The size of the block and information it should contain should heve been defined previously using option F.2 The block always contains the surname in its top line; the surname of of a descendant is joined to their first spouse (if any) by a sequence of '=' signs; the first spouse is similarly connected to the second (if any) and the second to the third. However, if you have indicated by an X in field 24, 28 or 32 of the form that the marriage of the spouse was not solemnised, the corresponding '=' signs will be replaced by '~' signs. Note that, just as with pedigree listings (F.1), the progeny of marriages between cousins (etc.) are not listed twice. Such marriages are marked on their second occurrence by an additional line in the block which draws attention to the fact that the marriages is between relatives. It is essential that you do not remove your data disk while NEWGEN.PED is being constructed. If your chart is very extensive, this process may take some time but NEWGEN gives you a running report on its progress. Do not attempt to edit or print NEWGEN.PED; it is written in a very special way. H.1 Print current drop line tree -------------------------------- This facility allows you to print out your tree chart (sideways) as explained above (G.1). Several options are available. Firstly you can, if you wish, select the style of the characters - the font - in which it will be printed. If you opt for this NEWGEN will display a list of the font files (.GNT) available (if any) on your data disk. You will be asked to indicate which one you want. Details of how to create a suitable font file are fully explained in Appendix A. If you do select to import a font in this way, you can choose to print it normal (8 x 16) size or double (16 x 32) size. If you opt, however, to use the standard system font, you can select one of four different sizes of character: # height width 1. 6 dots 6 dots 2. 8 8 3. 16 8 4. 32 16 The precise size of the characters in your printed tree depends on your printer and the graphics mode selected (see section 8 and appendix D). The smallest size, #1, results in the most compact chart; you will probably only want to use it for reference purposes. The largest size, #4, takes a long time to print out and is probably only useful to hang on the wall at family gatherings. Sizes #2 and #3 are the most useful for general purposes. Once you made these selections, NEWGEN will display on the screen details of how many pages and how many strips your chart will require. It then asks you how many copies you want to print out. You can specify 1 to 9 copies. It displays a running count of the copy, strip and page it is currently printing. NEWGEN will pause at the end of each strip and attempt to align the paper in such a way that each strip is the same length and starts at the same point relative to the top of a page. This may not work properly for all printers and as an alternative you can ask it to halt at the end of each strip while you adjust the paper. Note that you may find a completely blank page being printed sometimes; this is quite in order and is a consequence of the necessity of having the same number of pages in each strip. You may also find a completely blank page at the end of each strip. This may happen occasionaly and is a consequence of a variable distance (from printer to printer) between the tear bar and the print head (NEWGEN assumes this to be 1"). Before printing starts (and this may take some time if your tree is extensive) you have the opportunity of aborting by pressing ESC. Similarly, if you press ESC during printing, it stops (at least as soon as any printer buffer has been emptied). Assuming you opted to carry on, NEWGEN then reads the information, from NEWGEN.PED (which you have already prepared as described above in G.1) and prints it, strip by strip. When it has completed the first chart it, goes on to print another if you have ordered more than one, and so on till all is done. When everything is finished, you have the opportunity of going back to the beginning to select a new font or size and print again. A.2 Display useful information -------------------------------- This facility enables you to display on the screen the contents of a file called NEWGEN.NOT residing in your data disk. If there is no such file there, you will be told. The display pauses every 24 lines as explained in section 20. NEWGEN.NOT as supplied contains a list of dates useful to the British genealogist but you can edit it if you wish, or even replace it with a copy of NEWGEN.DOC renamed (at the desk top) as NEWGEN.NOT. I do not advise this however since NEWGEN.DOC is a very large file which would take up too much valuable space on your data disk and because it would take a considerable time to read to the end. B.2 Create/edit note sheets ---------------------------- The form into which you enter particulars of people is somewhat limited in its scope. There is no provision for recording anything about wills or other personal details. Inevitably you will know more about some people than others. This facility enables you to create or edit a more extended record for a specified person. Such a record, called a NOTE SHEET, can contain up to 25 lines of text, 80 charaters to a line; i.e. one screenful of text. The note sheets are written into a file called NEWGEN.TXT which could become very large. If you have only one drive (mode A), there may not be room for many note sheets, but you should have little trouble if you have two drives or a hard drive (modes 2 or 3). There are two ways of invoking this facility: 1. From the second page of the menu: Option B.2 In this case the ID of the person must be entered 2. By pressing F8 while a form is displayed In this case the ID is taken from the form Note that there must be a record in NEWGEN.DAT; If the ID on the form corresponds to a new entry, you must press F1 (to save the record) first and then enter the ID number again. Once the ID number has been specified, NEWGEN proceeds as follows: 1. If there is no pre-existing note sheet for the person, NEWGEN creates one (if there is room on the disk) and copies the full name of the person and their ID number into the first line. 2. If a note sheet already exists in NEWGEN.TXT, NEWGEN reads it in and displays it on the screen. When this has been done, you can type in whatever information you like or edit what is already there. The editing facilities are quite extensive and are similar to those found in many editor or word processing programs. A complete list of the commands you can use to move the cursor, find, replace etc. can be viewed by pressing the F1 key. Note that you can run it in either of two modes: overwrite or insert; you can easily change mode by pressing Cntrl INSERT simultaneously. Play with it a while before starting serious work. When you have finished, you can instruct NEWGEN to save your new or edited note sheet by pressing Cntrl X, or quit without saving by pressing ESC or Cntrl Q. C.2 Display/print note sheets ------------------------------ This facility enables you to display and print out a note sheet created by facility B.2. It is quite straightforward if you follow the few instructions displayed. D.2 Check all data on record ------------------------------ With the best will and the greatest care you will inevitably make mistakes while entering data in the forms. This facility gives you a limited ability to detect them. It will also draw attention to unusual events (e.g. a child born before its parents marriage) which may or may not indicate an error. The records in NEWGEN.DAT are checked against one another, one by one, and anomalies of various sorts listed. When it has finished NEWGEN displays a table listing people with anomalous records and the type of anomaly detected. This table is displayed 5 lines at a time. N.B. It makes no attempt to correct any anomalies it finds - that is up to you. Some of the anomalies it looks for should never occur because NEWGEN prevents them happening. If such are detected, it is an indication that NEWGEN.DAT has become corrupt or contains a bug - bad luck - but the chances of this happening are low. There are three anomalies of this sort: a missing surname, gender or ID number of the person or an ID number which is out of range. Here is a list of the anomalies NEWGEN looks for: A. No gender specified B. Gender is not M or F C. Gender of father is wrong D. Gender of mother is wrong E. Father is not married to mother F. Mother is not married to father G. Father ID # out of range H. Mother ID # out of range Spouse 1: I. Gender is wrong J. Not married to person K. ID # out of range Spouse 2: L. Gender is wrong M. Not married to person N. ID # out of range Spouse 3: O. Gender is wrong P. Not married to person Q. ID # out of range R. No surname or illegal number S. Father died before birth T. Mother died before birth U. Marriage dates do not match V. Parents married after birth W. Father born too early or late X. Mother born too early or late Y. Married before puberty Z. Married after death a. One but not two parents defined E.2 Define macros ------------------- It is possible to define up to 10 preset strings of up to 12 characters called MACROS. This strings can be inserted into the current field of the form by holding down a SHIFT key and pressing a function key (F1 - F10). The characters can be selected from any on the main keyboard including spaces. Characters are then copied from the macro to the field in so far as they are valid for the field. Macros may be defined or edited using this option. You can move the cursor from one macro to another using the up/down arrow keys. BACKSPACE deletes the character behind the cursor. When you have finished. press ESC. When you leave NEWGEN using menu option S, your macros are saved for use when you return to NEWGEN. F.2 Define drop line chart format ---------------------------------- The routine invoked by option G.1 constructs NEWGEN.PED. In this it writes a block of information for each person. The format for this bock can be inspected or defined by this option. As soon as the option is invoked, a box is displayed which demonstrates the current format. You can then press: RETURN to leave the format unchanged or D to set the default format or S to define the format of your choice. A format, once defined, is kept until you redefine it. It survives an exit from NEWGEN. The first parameter to be defined is the number of characters accross the width of the block; the default is 14, but it can be any number between 2 and 64. If a width less than 14 characters is chosen, it is possible that some items of information will be curtailed. A width of 2 will give only the first character of each item. Next there is the specification of the information to be included in the block. There may be up to 10 lines containing up to 9 items. The items are taken from the record of the person concerned. If the item was not defined in the form, the corresponding line is omitted from the block. The first item is the surname. This is always defined and always included at the top of the block. The items you can select (and the default selection) are indicated below: Default (1. Surname) Y 2. First name #1 Y 3. #2 Y 4. #3 Y 5. Birth or baptismal date Y 6. Death or funeral date Y 7. Marriage date (spouses only) Y 8. Occupation Y 9. Abode Y 10. Blank line to make it look better N Finally, if your block width is 4 or more, you can select to include the ID number. This is written into the last three positions of the block. Note that if the block width you have specified is less than 17, the last three characters of the surname may be overwritten by the ID number. To be safe, specify a block width of at least three more than the length of the longest surname. The default is not to include the ID number. Note that baptismal dates are only included if birth dates are undefined and similarly funeral dates only if death dates are undefined. Note that there is no way of altering the order of the items in the block. The when you exit from NEWGEN, current format is saved in NEWGEN.DAT for use when you return to NEWGEN. G.2 Set date -------------- NEWGEN writes the date at the bottom of birth briefs and pedigree listings and at the top of listing of people. This facility gives an easy way of telling NEWGEN what is the date you want to use (today's?). At the same time it sets the system date much as you would do with the control panel at the desk top. Enter the date in the three fields displayed which correspond to the day, the month and the year. Each field requires two digits. Silly days such as 45 are impossible to enter as are silly months. The earliest possible year is 1980. You cannot enter September 31st, etc., though you can always enter February 29th. If you louse it up, you can try again by pressing ESC which clears the date; if you make a mistake, BACKSPACE deletes the last digit entered. When you have completed the entry, press RETURN H.2 Change data disk ---------------------- It may be that you have several data disks (or hard disk partitions containing NEWGEN.DAT files); maybe one contains your ancestors and another contains those of your partner. Option H.2 allows you to return to the stage of the program where you specify your data disk. You can then process your next set of data or opt to quit NEWGEN. 22. Crashes and bugs -------------------- NEWGEN is so designed to minimise the possibility of a crash - an unexpected end to the operation of the program. In particular NEWGEN checks while it is writing to a floppy disk that there is room for the data it is about to write. If there is not, it displays a warning message and stops. Note that it always assumes there is at least one Megabyte of free space on a hard disk (or partition) - so make sure there is (i.e. don't clutter up your hard disk partition) [the reason for this is that it takes the operating system an unacceptably long time to find out how many free bytes there are on a hard disk]. It is unlikely that NEWGEN will crash because of a fault in the program (it has been extensively tested) but it is just possible that there is a bug lurking in it which I have not detected. If you find one, perform a public service and let me know - with as much detail as possible and I will try to fix it. If you do have to report a bug, make sure you send full details of the equipment you are using (TOS version number if you can) and precise details of the nature of the bug and how and when it was manifest. Remember that if NEWGEN does not work on your system for whatever reason, I will, at my discretion, either refund your money or fix the program. NEWGEN frequently checks to ensure that the correct disk is in the correct drive. If it detects something wrong, it prompts you to load the appropriate disk. Nevertheless, NEWGEN cannot spend all its time making such checks and you should not remove a disk unless NEWGEN asks you to. If NEWGEN expects to find a disk in a drive and finds none there, the system will show an alert box. You can continue by loading a disk and pressing RETURN. It is possible to have a power failure while using NEWGEN or your dog might succeed in pulling out the plug; again your computer may develop a fault or one of the leads at the back might become disconnected or you might have reset your ST etc. I hope that such things never happen to you, but rest assured, it is unlikely that your data will be harmed. A more devastating event is damage to or failure of a disk. USE GOOD QUALITY DISKS and BACK UP YOUR NEWGEN.DAT FILE REGULARLY. You have been warned. If a disk does cease to work properly, you could try cleaning your disk head and there are programs on the market with which you may be able to retrieve all or some of a file. [Technical note: The only occasion when NEWGEN.DAT is written to is just after you press F1 or F9 to save the data in a form. This is when your data is most vulnerable. If perchance there is a power cut etc. while this is happening, you are only likely to lose the record(s) you were entering at the time. You should check it out using option A.1 when you next start NEWGEN] As a fail safe device, NEWGEN.TRE is marked when you start up NEWGEN and the mark expunged when you exit from NEWGEN. If at the start, NEWGEN finds NEWGEN.TRE marked, it assumes that it is corrupt and recreates it from scratch as opposed to reading it in (which is the normal and quicker procedure). 23. Updates, Enhancements and other programs available ------------------------------------------------------- From time to time NEWGEN will be updated and new facilities added. As a purchaser of NEWGEN, you will be informed from time to time about their availability, but it may be worth your while asking me. It is my policy to try to ensure that your precious NEWGEN.DAT file is compatible with all future revisions of NEWGEN. Should this not be possible, a program to reformat the file would be provided. Note however that NEWGEN.TRE and GENINF.PRG (& NEWGEN.INF) may well change and you should always use the version of the latter that comes with NEWGEN.PRG As well as the standard NEWGEN described above, a version called NEWGEN5K is available. It requires an Atari ST, STE or Mega with at least 1 Megabyte of RAM and a hard drive to run, but it allows you to enter up to 5000 people. If you possess a NEC 24 pin printer, a program to print out .PED files and make use of the increased resolution is available. This was written and made available by Steve Davies. Also available is a disc containing 56 .GNT fonts suitable for use with NEWGEN. These vary from the elegant to the horrible. The DEMO version - which allows entry of only 18 people - is also available and is in the public domain; it may be freely distributed. 24. Pricelist -------------- Cost Cost if a disk & P&P is sent NEWGEN Standard version 17.00 15.00 NEWGEN 5K if you already have the standard version N.A. 3.00 if you do not have the standard version 20.00 18.00 NEWGEN Demo version 2.50 Gratis Disk of font (.GNT) files 2.50 Gratis 24 pin printer program 2.50 Gratis Minor update of NEWGEN 2.50 Gratis The author reserves the right to change this pricelist from time to time. 25. Disclaimer and conditions of use ------------------------------------- 1. Copies of the software supplied shall only be made for the purchaser's personal use. 2. No copy of the software in any form may be given, lent or sold to any third party. 3. NEWGEN is sold on the understanding that the author, E.G.Richards, shall not be held responsible for any loss, financial, or of data or time, arising from the use of NEWGEN, howsoever caused. 4. If for some unforseen reason, NEWGEN fails to work on the purchaser's system, or if a programming error comes to light, the author will either refund the cost price or arrange to supply a corrected version at his discretion. If you cannot agree to these conditions, please return your disk to the author who will make a full refund of the money you paid. 5. I am always prepared to offer help or guidance in the use of NEWGEN (but NOT in Genealogy). If you require such help of if your copy of the program appears not to work, write with full details of your system and with as much information about the fault as possible. There may be a delay since I am sometimes away. It is worth ringing me in the evening on 081-693-7499. Appendix A FNTCON.PRG ---------------------- Normally your tree will be printed in characters which closely resemble those you see on the screen. This style of characters is that of the STANDARD (or system) FONT. It is possible to read in (or import) a font of characters in some other style. These must be in a file on your data disk which must have the extension .GNT and contain exactly 4096 bytes. Font files are supplied with several utility programs for ST computers, but these come in a variety of different forms. The program FNTCON.PRG enables you to convert several different types of font file to produce .GNT files which can be read and used by NEWGEN for printing your drop line trees. FNTCON is not able to convert all possible fonts; only those which: 1. are 8x16 bit mapped fonts 2. contain 128 or 256 characters 3. are not proportional fonts (do not be concerned if you do not grasp these technicalities) To run FNTCON, double click on FNTCON.PRG and follow the instructions. At some stage you will be asked to supply the file name. If the font you want to convert is in a file called (for instance) HELVETIC.FNT, enter: HELVETIC.FNT. FNTCON will first ask you to specify the type of font; some help in deciding the type to specify is given below. FNTCON will read it in and make several tests. It may reject it if it finds that it is in a form it cannot cope with. If it accepts it, it will display all the characters in the font, which are used by NEWGEN, on the screen. If you like what you see, you can save the converted font (e.g. as HELVETIC.GNT). If what you see offends you or is a meaningless jumble of dots, you could try again using a different font type. Maybe you will produce something satisfactory. If, in the end, you do not succeed, it means that the font is not in a suitable form to be converted. Here are the five categories together with an indication of some sources of appropriate font files: 1. Transposed font; 128 characters e.g. 8x16 fonts supplied with MEGAFONT and DEGAS 2. Transposed font; 256 characters 3. Standard font; 128 characters 4. Standard font; 256 characters 5. GDOS 8x16 font; 128 or 256 characters e.g. 8x16 fonts supplied with DEGAS ELITE (SS16 only) Many other fonts are available with other programs and and even more from software libraries. A disk containing 56 .GNT fonts is available (see section 23). Note that fonts supplied for use with Publishing Partner are NEVER suitable. Appendix B PRINTIT.PRG ----------------------- If you try to print a file (such as NEWGEN.BRF or NEWGEN.DES) containing more than 80 characters to a line on a standard lineprinter, the result will be unsatisfactory and characters are likely to fall off the end of the paper. One solution is to buy a more expensive wide carriage line printer; a cheaper solution is to print the file using PRINTIT.PRG. Providing your printer understands the appropriate control codes (EPSON compatibles should) PRINTIT will print the file using condensed characters; you can get 132 of these on a standard printer line. PRINTIT.PRG also has a facility to enable you to print out long documents such as NEWGEN.DOC with gaps between the pages which are numbered. To use PRINTIT, just double click on PRINTIT.PRG and follow the instructions. Appendix C Joining strips -------------------------- If you have succeeded in tracing back through many generations, or if you elect to print your tree using one of the larger sizes of print, there may not be room enough to contain the entire depth of the chart in the width of a page. NEWGEN copes with this by printing the chart in several strips. These should each be the same length, and can be joined together to give a composite chart. It is really up to you how you join them together but here are some tips: 1. First carefully remove, at the perforations, the strips of sprocket holes. 2. Then carefully separate the strips - it is easy enough to separate them at the wrong point. Do NOT separate the individual pages of a strip. 3. If you now unfold the strips and lay them side by side, all being well, you will see how they should be aligned if they are overlapped by an inch or so. 4. To make a clean join you will have to remove a strip from the top edge of the lower strip or the bottom edge of the upper. This is best done by fan folding the strip up and cutting carefully with a guillotine if one is available. Otherwise you must do it with scissors. In either case ensure that the thin strip of paper you remove is straight and that the cut is parallel to the edge of the paper. 5. You now need a large table or a clean hard floor. Lay out two strips and align them. Get someone to hold one end while you align the other. Maybe you can temporarily stick one strip down while you align the other. Dabs of 'Pritt' glue between the overlapping regions help. Take your time and get the two strips perfectly aligned and overlapping by just the right amount. 6. When they are perfectly aligned, stick them together with strips of 'invisible sellotape' over the join (do NOT use ordinary sellotape - you will regret it if you do). Apply strips of sellotape about a foot long; do not attempt to apply a long strip stretching from one end to the other. When you have done this, turn the strips over and apply more 'invisible sellotape' over the join on the reverse side. Then join the third strip in a similar way and so on. 7. You can protect the chart from disintigration by placing small pieces of tape over the joins of the pages at the top and bottom edges. If you have joined the chart together with extreme care, you may be able to fan fold it. More likely, you will have to roll it up - but it will never lie flat again if you do! 8. You can buy spray on lacquer and a thin coat of this will help to protect your chart. Appendix D Printer codes ------------------------- Most available lineprinters are Epson compatible, that is to say that the sequences of bytes that you have to send to the printer to make it do various things is the same as with the Epson make of printers. Even so some printers billed as Epson compatible can do more than others. Here is the default list of codes and the effect NEWGEN expects of them: # Decimal Effect Hex ASCII ------------------------------------------------------------------------ 1. 12 Form feed 0C FF 2. 24 Clear printer buffer 18 CAN 3. 27,64 Reset printer 1B,40 ESC,@ 4. 27,67,n Set paper length to 1B,43,n ESC,C,n n lines 5. 27,51,n Set line feed pitch 1B,33,n ESC,3,n to n pin spacings 6. 10 Line feed 0A LF 7. 13 Carriage return 0D CR 8.3 27,42,4,n,m Set to CRT graphics 1B,2B,04,n,m ESC,*,n,m mode (8 pin) n+256*m is the number of bytes to expect 9. 15 Set condensed mode 0F SI 10. 18 Cancel condensed mode 12 DC2 11. 27,4 Set italics 1B,04 ESC,4 12. 27,5 Cancel italics 1B,05 ESC,5 Code #8.3 (which is used for the CRT mode) may be replaced, according to the graphics mode selected in GENINF.PRG by: 8.1 27,75,n,m Set to single density 1A,4B,n,m ESC,K,n,m graphics mode (8 pin) or 8.2 27,76,n,m Set to double density 1A,4C,n,m ESC,L,n,m graphics mode (8 pin) Number are substituted for n and m as appropriate. These codes are written into NEWGEN.INF by GENINF.PRG. NEWGEN.INF may be edited to change the codes if necessary - see appendix E Appendix E NEWGEN.INF ----------------------- NEWGEN.INF is an ASCII file created by GENINF.PRG. It can be edited with the aid of an Editor such as 1st Word in ASCII mode (NOT WP mode). It contains 14 lines. Except for the first two, each line contains several integer decimal numbers. Each such number is allocated a field of 4 columns and is right adjusted therein with no leading zeros (I4 format). The first line contains the current version number (e.g. 4.10) taking up 4 columns. The second line contains 6 numbers in I4 format followed by a string of letters which denote the disk drives specified: 1. NPOINT, the paper length in points 792 2. WIDTH, the useful page width in inches 8 3. HPI, the horizontal dot pitch in dots/inch 80 4. VPI, the vertical dot pitch in dots/inch 72 5. X, the quantity referred to in section 8 216 6. NDRIVE, the number of drives 7. SDRIVE, the string of drive letters (the numbers on the right are the default values) The other 12 lines specify the printer codes described in appendix D. The number of integers on each line varies with the code, but invariably the first such integer denotes the number of bytes in the code. In code #4, n is replaced in NEWGEN.INF by the page length in lines - the integral part of NPOINT/12 In code #5, n is written as 0 in NEWGEN.INF but NEWGEN replaces the zero with some other number as required. In code #8 (1,2 or 3), n and m are written in NEWGEN.INF as: n = MOD(N,256) - The remainder when N is divided by 256. If the result is >127, 256 is then subtracted. m = N/256 - The integral part. Here N is equal to the horizontal dot pitch (in dots/inch) multiplied by the page width (in inches) as defined above for line #1 As mentioned in appendix D, line 9 will contain code 8.1, 8.2 or 8.3 according to the graphics mode selected. If you alter any of these codes, ensure that: a. There are 12 codes which perform the functions noted. b. Not more than 40 numbers are used in the codes. c. The first number on each line defines the number of bytes in the code. Appendix F Character sizes in drop line charts ------------------------------------------------ Each characters printed in a drop line chart can be viewed as being contained in a 'cell'. The size of this cell depends on: a. The font size selected in option H.1 b. The horizontal dot pitch (HPI) defined in GENINF.PRG c. The vertical dot pitch (VPI) defined in GENINF.PRG The width and height of the character cell (in points of 1/72") can be calculated from: Size Width Height 1 (6 x 6) 432/VPI 432/HPI 2 (8 x 8) 576/VPI 576/HPI 3 (8 x 16) 576/VPI 1152/HPI 4 (16 x 32) 1152/VPI 2304/HPI Since HPI can in principle take three different values (usually 60, 120 or 80) according to the graphics mode selected, twelve different cell sizes are available if you have a printer which supports all three modes. Appendix G Enhancements in NEWGEN versions 4 --------------------------------------------- The following enhancements are available in versions 4 which were not available in earlier versions of NEWGEN: 1. NEWGEN works with colour monitors (4.00) 2. The routine for printing drop line charts has been speeded up but you no longer get a preview on the screen (4.00) 3. You can create new records for relations using the 0 option (4.00) 4. Marriages can be copied automatically to the partner's record (4.00) 5. You can print family groups (4.00) 6. You can list isolated records (4.00) 7. You can configure NEWGEN for some non-Epson printers (4.01) 8. It is easier to configure NEWGEN for different types of printer (4.02) 9. Baptism and burial dates are entered in drop line charts in lieu of birth and death dates (4.03) 11. Baptism dates are used in lieu of birth dates in listings (4.03) 10. ID numbers can be entered into drop line charts (4.03) 11. Versions numbers of NEWGEN.RSC and NEWGEN.INF are now checked (4.03) 12. Facility for defining macros and using them in forms (4.05) 13. Number of children and existence of note sheet shown on form (4.06) 14. Separate option to define drop line tree formats (4.06) 15. Note sheet editor overhauled and changed (4.06) 16. Drive usage redefined (4.06) 17. ID numbers in ancestor and descendant lists (4.06) 18. Print out of records improved; note sheets can be printed also (4.06) 19. Facility to print all note sheets (4.06) 20. Birth brief routine rewritten for 9 generations (4.06) 21. Connecting lines introduced in descendent lists (4.06) 22. Errors in page length, italic printing etc. corrected (4.07) 23. Errors in drop line trees corrected (4.08,4.09,4.10) In all new versions, every bug that came to light in previous versions has been eliminated. About the Author ---------------- I am an 'early' retired scientist and I have been writing computer programs since 1961. I became interested in genealogy several years ago. The bother of trying to write pedigree charts by hand and having to start again and again lead me to write a program for my own use. Several other genealogists heard of my program and I persuaded myself to rewrite it in a more robust and generally useful form. This took several months. I charge for NEWGEN because otherwise I would never get round to distributing it and because there were overheads in writing the program. About NEWGEN ------------ NEWGEN is mostly written in FORTRAN 77 but some of the subroutines are written in Assembler and it makes extensive use of calls to the Operating System. It is thus not readily transportable to other computers. An attemopt has been made to make it run as fast as possible and to ensure that it reasonably foolproof. For the more adventurous ------------------------ It is possible to edit the ASCII file NEWGEN.RSC. This contains the text that appears against the menu items, the layout of the form and other data. N.B. Every number in NEWGEN.RSC is a decimal integer and takes up 4 character positions with leading blank spaces. The information in it is in five parts: 1. The version number 2. The number of menu items (16) followed by the menu entries You can alter the wording of these (up to 40 characters each) if you like but not their number or order. 3. The pattern of the form; this can contain up to 24 lines and is terminated by a dot on a separate line. You can alter the wording and even the positions of the fields, but you must on no account alter the sizes of the fields or the number of them; chaos will result if you do. 4. The number of boxes to be drawn followed by the X (1-80) and Y (1-25) coordinates of the top left and bottom right corners of each. You can alter these at will. 5. A number specifying the number of fields on the form (which must not be altered) followed by 34 lines which specify each field. Each set contains 9 decimal numbers arranged in columns: 1. The field number 2. The row it is in (the first line of the form is on row 2) 3. The column it starts at (1-80) 4. The length of the field (number of underlines) 5. The next field to be visited when you press a forward TK 6. The next field to be visited when you press a backward TK 7. The type of field: 1 for a number; 5 for a string 8. The current length of the field (always 0) 9. The position in the record at which the field data starts You can alter the numbers in columns 2,3,5 or 6, but on no account should you alter those in columns 1,4,7,8 or 9. If you do make such alterations, be sure to rearrange the fields in the form. You may like to note that if you can remember the sequence of key presses required to achieve some desired effect, you can press them in quick succession without waiting for the prompts to appear and produce the same effect. Note, however, that you cannot pass the menu in this way - the type ahead buffer is emptied before the menu is rewritten. Use this facility with care, NEWGEN might crash if the buffer becomes full. N.B. You do all this at your own risk and can expect no help from me! E.G.Richards April 1991